Leadtools.Codecs Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.17
WriteTransformMarker(Int32,Byte[],Int32,Int32) Method
See Also 
Leadtools.Codecs Namespace > RasterCodecs Class > WriteTransformMarker Method : WriteTransformMarker(Int32,Byte[],Int32,Int32) Method




id
The id of the metadata marker.
data
A byte array containing the data for the metadata marker.
dataOffset
Offset into data into which to beging the read operation.
dataLength
Number of bytes to read from data.
Controls how the transform markers are used when performing a lossless transformation for certain formats.

Syntax

Visual Basic (Declaration) 
Overloads Public Sub WriteTransformMarker( _
   ByVal id As Integer, _
   ByVal data() As Byte, _
   ByVal dataOffset As Integer, _
   ByVal dataLength As Integer _
) 
Visual Basic (Usage)Copy Code
Dim instance As RasterCodecs
Dim id As Integer
Dim data() As Byte
Dim dataOffset As Integer
Dim dataLength As Integer
 
instance.WriteTransformMarker(id, data, dataOffset, dataLength)
C# 
public void WriteTransformMarker( 
   int id,
   byte[] data,
   int dataOffset,
   int dataLength
)
Managed Extensions for C++ 
public: void WriteTransformMarker( 
   int id,
   byte[] data,
   int dataOffset,
   int dataLength
) 
C++/CLI 
public:
void WriteTransformMarker( 
   int id,
   array<byte> data,
   int dataOffset,
   int dataLength
) 

Parameters

id
The id of the metadata marker.
data
A byte array containing the data for the metadata marker.
dataOffset
Offset into data into which to beging the read operation.
dataLength
Number of bytes to read from data.

Example

For an example, refer to Transform.

Remarks

You should use this method to write a certain marker data into the file.

This method can be called only from within the CodecsTransformMarkerCallback passed to the Transform method.

The transform mechanism is as follows:

  • You call Transform.
  • Transform will call the CodecsTransformMarkerCallback callback passed to it for every marker contained in the source file. In the callback, you can replace markers, insert markers or allow Leadtools to do the default processing (recommended).
  • You can override the default action for a marker by returning one of the following values from the transform callback:

Note: You can also use WriteTransformMarker to insert your own markers. The marker will be inserted before the current marker. You can call WriteTransformMarker as many times as you wish. Every call to WriteTransformMarker will insert a new marker.

Warning: Incorrect handling of the markers will generate corrupt files! Since some markers contain important information about the image (image width, height, compression method, colorspace, etc), you should use caution when working with markers.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also